home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / povmen.zip / POVMENU.DOC < prev    next >
Text File  |  1992-12-24  |  85KB  |  1,930 lines
  1.      
  2.      
  3.      
  4.      
  5.                                                               POVMenu v1.1b
  6.      ======================================================================
  7.        A Menu Driven User Interface For The Persistence Of Vision Raytracer
  8.                                                              (POV-Ray v1.0)
  9.      
  10.      
  11.      
  12.      
  13.      
  14.      
  15.      
  16.      
  17.      
  18.      
  19.      
  20.      
  21.      
  22.      
  23.      
  24.      
  25.      
  26.      
  27.      
  28.      
  29.      
  30.      ======================================================================
  31.                                                         POVMenu USERS GUIDE
  32.      ======================================================================
  33.      
  34.      
  35.      
  36.      
  37.      
  38.      
  39.      
  40.      
  41.      
  42.      
  43.      
  44.      
  45.      
  46.      
  47.      
  48.      
  49.      
  50.      
  51.      
  52.      
  53.      
  54.                        BETA RELEASE - PLEASE DO NOT DISTRIBUTE!
  55.      
  56.      
  57.      ======================================================================
  58.                          POVMenu Is FreeWare From The Graphics WorkShop BBS
  59.                 Copyright(c) Dennis Dodd, 24 Dec 1992, ALL RIGHTS RESERVED!
  60.       Tech Support & Inquires: (901) 458-9456 * USR d.s. * FidoNet 1:123/57
  61.  
  62.      
  63.      
  64.      
  65.      
  66.      
  67.                               POVMenu version 1.1b
  68.      
  69.      
  70.      
  71.                                     Contents
  72.      
  73.      
  74.      
  75.      ======================================================================
  76.      
  77.          Quick Start ..............................................  1
  78.      
  79.          Upgrading From Version 1.0 ...............................  2
  80.      
  81.          Introduction .............................................  3
  82.      
  83.          Disclaimer & Copyright Notice ............................  4
  84.      
  85.          Software & Hardware Requirements .........................  4
  86.      
  87.          Features .................................................  5
  88.      
  89.          Files Included In The Archive ............................  6
  90.      
  91.          Installing POVMenu .......................................  7
  92.      
  93.          The Directory Structure .................................. 11
  94.      
  95.          Menu Operation ........................................... 12
  96.      
  97.          F10 - Convert To GIF ..................................... 14
  98.      
  99.          Configuration Screen Options ............................. 16
  100.      
  101.          QuickView Display Options ................................ 20
  102.      
  103.          The User Definable Menu Picks ............................ 29
  104.      
  105.          Command Line Display ..................................... 30
  106.      
  107.          If You Have Problems With POVMenu ........................ 30
  108.      
  109.          Program Credits .......................................... 30
  110.      
  111.          Release History .......................................... 31
  112.      
  113.      
  114.      ======================================================================
  115.  
  116.  
  117.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  1 
  118.      ======================================================================
  119.  
  120.  
  121.      A QUICK START - FOR THE IMPATIENT POWER USER
  122.      ----------------------------------------------------------------------
  123.      If you are one of those kinds who hates to read documentation, then
  124.      hopefully this page will get you going.
  125.      
  126.      [1] Let me get something straight...  POVMenu does not require a pre-
  127.          defined directory structure to operate correctly.  It can be
  128.          adapted for use with almost any directory setup.  If you wish to
  129.          use POV-Menu with your existing directory structure, this will
  130.          require a little reading on your part.  Please refer to the
  131.          section outlining the CONFIGURATION screens.  There you will find
  132.          instructions on how to setup POVMenu with an existing directory
  133.          structure.
  134.      
  135.          If you are a new comer to POV-Ray, then begin with a copy POV-Ray
  136.          installed in the directory structure as recommended in the POV-Ray
  137.          v1.0 docs, page 10.
  138.      
  139.      [2] Create a new directory off of the \POVRAY directory called
  140.          'IMAGES'.
  141.      
  142.      [3] Install the files contained in the POVMenu archive in the \POVRAY
  143.          directory.  Move the file RUNPL.BAT to the POVRAY\UTIL directory.
  144.      
  145.      [4] Run the INSTPOVM program.  Supply the hard drive letter and the
  146.          POV-Ray run directory name ('\POVRAY' normally).
  147.      
  148.      [5] Make sure that the '\POVRAY' and the '\POVRAY\UTIL' directories
  149.          are on the DOS path and re-boot your system if needed.
  150.      
  151.      [6] Fire up POVMenu by typing "POV" and [ENTER] at the DOS prompt.
  152.      
  153.      [7] Press ALT-F1 and fill in the following fields with the requested
  154.          information:
  155.      
  156.          1)  The name of the .POV file you would like to Edit/Render.
  157.      
  158.          8)  The name of the POV-Ray executable you are running.
  159.      
  160.          9)  The name of the image processing program used to 'touch up'
  161.              and add text to your final GIF files (IMPROCES or VGACAD).
  162.      
  163.         10)  Your favorite file browser (LIST.COM).
  164.      
  165.         11)  Your favorite GIF file viewer (VPIC or CShow).
  166.      
  167.         12)  The name of your favorite hard disk manager utility (QDos,
  168.              X-Tree, etc...).
  169.      
  170.         13)  The name of your text editor (Qedit, Multi-Edit, etc.).
  171.      
  172.      [8] Press ALT-F1 and select the desired Convert-To-GIF method.  Press
  173.          [ESCAPE] to return to the main configuration screen.
  174.      
  175.      [9] Press ALT-F2 and fill in the user definable Utility program names
  176.  
  177.  
  178.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  2 
  179.      ======================================================================
  180.  
  181.  
  182.          and menu tags.  Press [ESCAPE] to return to the main configuration
  183.          screen.
  184.      
  185.      [15] Press [ESCAPE] to save the configuration and exit.
  186.      
  187.      [16] Enjoy POVMenu!
  188.      
  189.      
  190.      UPGRADING FROM VERSION 1.0
  191.      ----------------------------------------------------------------------
  192.      If you have been running version 1.0 of POVMenu, please be advised that
  193.      version 1.1 IS NOT A DROP IN REPLACEMENT!  The POVMenu configuration
  194.      file format has been changed.  To install and run version 1.1 you *MUST*
  195.      first run the INSTPOVM program and convert your existing configuration
  196.      file.  To upgrade to version 1.1 follow these steps:
  197.      
  198.      [1]     Move the archive (POVMNU11.ARJ) into your POV-Ray run directory
  199.              and unARJ it with the overwrite option, using the following
  200.              command line:
  201.      
  202.              ARJ e -y POVMNU11
  203.      
  204.              (ARJ is case sensitive.  You MUST type the command line just
  205.              as it appears above.)
  206.      
  207.      [2]     Run the INSTPOVM program.  When asked "Are you upgrading from
  208.              a previous version of POVMenu?", answer [Y]es, and press
  209.              [ENTER].  Next the program will ask "Would you like to convert
  210.              your old configuration file?", answer [Y]es, and press
  211.              [ENTER].
  212.      
  213.      [3]     Copy the file RUNPL.BAT into your \POVRAY\UTIL directory.
  214.              RUNPL.BAT is an example batch file for using the user
  215.              defined menu picks.  See the section on 'The User Defined
  216.              Menu Picks' for more info on this subject and recommendations
  217.              on how to set them up.
  218.  
  219.  
  220.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  3 
  221.      ======================================================================
  222.  
  223.  
  224.      
  225.      
  226.      INTRODUCTION
  227.      ----------------------------------------------------------------------
  228.      If you have gone to the trouble and expense to download this file and
  229.      begin reading this document, then you are probably frustrated by the
  230.      complicated command line driven user interface that the Persistence
  231.      of Vision raytracer provides.  POV-Ray is a *GREAT* raytracer, but the
  232.      command line options can get very confusing, especially for a new comer
  233.      to the program.
  234.      
  235.      I discovered POV-Ray during January of 1992.  In the months that
  236.      followed I rendered a bunch of files using a series of crude BAT files
  237.      that I wrote to take a little of the pain out of the EDIT/VIEW/RENDER/
  238.      CONVERT-TO-GIF process.  After a few months of this I decided that there
  239.      HAD to be a better way to interact with this wonderful program.  So, I
  240.      decided to write a simple but useful menu driven interface that would
  241.      ride on top of POV-Ray and call it with command lines instructing it to
  242.      perform all of the basic steps needed during the creation of a picture.
  243.      You may customize the command lines passed to POV-Ray and some of the
  244.      picks that appear on the Main Menu, allowing you to adapt POVMenu to
  245.      suit your personal tastes and needs.
  246.      
  247.      POVMenu started out as a goofy little program that I wrote in
  248.      QuickBasic that turned out to be indispensable when running POV-Ray on
  249.      a regular basis.  I *DO NOT* claim to be a guru programmer by any
  250.      stretch of the imagination, but the damn thing works, and works quite
  251.      well if you don't ask too much of it.  (At least the price is right!)
  252.      
  253.      If you find POVMenu helpful, let me know!  If you find room for
  254.      improvement, tell me and I'll wire it into the program.  If you
  255.      think it's a piece of crap, then delete it and save yourself a few
  256.      'K' of disk space.
  257.      
  258.      If you would like to contact me, please do!  I may be reached at
  259.      the following places:
  260.      
  261.         On my BBS:
  262.                       ** The Graphics WorkShop BBS **
  263.                   Node1: 901-458-9456  |  Both Nodes USR ds
  264.                   Node2: 901-323-9296  |  14.4K - HST/v.32b
  265.      
  266.         The Graphics Alternative BBS, 510-524-2780 (v.32)
  267.      
  268.         You Can Call Me Ray BBS, 708-358-5611 (HST and/or v.32)
  269.      
  270.         via FidoNet netmail at 1:123/57, or the FidoNet graphics echo
  271.      
  272.         Voice: 901-323-8183 (use your common sense, I work a day job!)
  273.      
  274.      The latest version of POVMenu may always be FREQed from 1:123/57
  275.      under the magic name 'POVMENU'.
  276.      
  277.      
  278.  
  279.  
  280.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  4 
  281.      ======================================================================
  282.  
  283.  
  284.      DISCLAIMER & COPYRIGHT NOTICE
  285.      ----------------------------------------------------------------------
  286.      In the spirit of Persistence of Vision, POVMenu is copyrighted
  287.      freeware.  This means:
  288.      
  289.      [legal b.s. mode on]
  290.      
  291.              1 - You are free to use POVMenu for your own personal use.
  292.      
  293.              2 - Please propagate POVMenu by uploading it to your favorite
  294.                  BBS or sharing a copy of it with a friend.
  295.      
  296.              3 - Use the program at your own risk!  The only thing that I
  297.                  grantee POVMenu to do is occupy disk space.  If it breaks
  298.                  your system, you own both halfs.  You should always
  299.                  maintain reliable backups of your hard drive(s) just in
  300.                  case something goes wrong!
  301.      
  302.              4 - I retain all rights to the program.  You may not hack,
  303.                  reverse engineer, or otherwise fornicate with the
  304.                  executables 'POVMENU.EXE' or 'INSTPOVM.EXE'.  You may
  305.                  not edit or modify the DOC file included in the archive.
  306.      
  307.              5 - The original distribution archive must be left intact
  308.                  and undisturbed.  The original archive is packaged in a
  309.                  virus free ARJ security envelope.  You may not repackage
  310.                  POVMenu in an alternate archive format such as ZIP or
  311.                  LZH.  The contents of the original distribution
  312.                  archive may not be altered in any way.  This includes
  313.                  adding 'ads' for your BBS to the archive or any other
  314.                  such extraneous files.  You may not change the comments
  315.                  that are displayed when the file is de-archived.
  316.      
  317.              6 - You may not charge money for POVMenu (beyond a handling
  318.                  fee not to exceed $5.00 US).
  319.      
  320.              7 - You may not include POVMenu in any commercial, shareware,
  321.                  or freeware product without the written consent of the
  322.                  author.
  323.      
  324.      [legal b.s. mode off]
  325.      
  326.      That's enough of that!
  327.      
  328.      
  329.      SOFTWARE & HARDWARE REQUIREMENTS
  330.      ----------------------------------------------------------------------
  331.      To use POVMenu, and take advantage of all the functions provided, quite
  332.      a few external programs are needed.  These programs are summarized
  333.      below:
  334.      
  335.              *  A copy of the POV-Ray executable (required!).  You're dead
  336.                 in the water without it.
  337.      
  338.              *  A text editor capable of receiving the file name to edit
  339.  
  340.  
  341.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  5 
  342.      ======================================================================
  343.  
  344.  
  345.                 on the calling command line such as QEdit, Multi-Edit, etc.
  346.      
  347.              *  An image processing program that may be used to 'touch up'
  348.                 and/or add text to your GIF files, such a IMAGE PROCESS or
  349.                 VGACAD.
  350.      
  351.              *  An image processing program capable of converting 24 bit
  352.                 TARGA files to 8 bit GIF files, such as Image Alchemy,
  353.                 PicLab, IMG2GIF, TGA2GIF, etc...
  354.      
  355.              *  A GIF file viewer such as VPIC or CShow.
  356.      
  357.              *  A file browser utility such as LIST.COM.
  358.      
  359.              *  A hard disk management utility such as QDos or X-Tree.
  360.      
  361.              *  Up to five of any of the popular utilities for POV-Ray
  362.                 like C-Render, C-Mapper, Coil, POVscape, etc. -or- any BAT
  363.                 files of your own.
  364.      
  365.      Most of these programs should be installed on your hard drive in
  366.      directories that are on your DOS path (like \UTIL or \BIN).  The image
  367.      processors should be installed in the directory that your TARGA files
  368.      are built in.  The POV-Ray utilities should be installed in your
  369.      \POVRAY\UTIL directory or be on the DOS path.  This is noted in this
  370.      document when required.
  371.      
  372.      Hardware wise, if your system will run POV-Ray, it will run POVMenu!
  373.      
  374.      
  375.      FEATURES
  376.      ----------------------------------------------------------------------
  377.      POVMenu provides the following features:
  378.      
  379.              *  Calls all programs from recursive batch files.  Effectively
  380.                 requiring *ZERO BYTES* in memory overhead to use!
  381.      
  382.              *  Calls up to five user defined programs or BAT files as menu
  383.                 picks on the main menu.  These may be any of the various
  384.                 POV-Ray utilities like C-Render, etc. or, user written BAT
  385.                 files.  Allowing you to add any functions to the main menu
  386.                 that you desire.
  387.      
  388.              *  2 'QuickView' modes, allowing you to render directly to the
  389.                 screen using the several color selection methods provided in
  390.                 POV-Ray.  2 resolutions are provided: 160x100 (1/4 screen)
  391.                 and 320x200 (full screen).  These pictures look pretty bad,
  392.                 but they are great for verifying that the basic color,
  393.                 shape, and placement of the objects in your scene are
  394.                 suitable.  Support provided for the palette option allowing
  395.                 you to use the HSV, 3-3-2, Gray Scale, or Sierra High Color
  396.                 palette DAC methods of color selection.
  397.      
  398.              *  Calls POV-Ray and renders your final product.  A variety of
  399.                 options are provided allowing you to control most aspects
  400.  
  401.  
  402.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  6 
  403.      ======================================================================
  404.  
  405.  
  406.                 of the output file, such as anti-alias on/off and threshold,
  407.                 rendering quality, output file type, etc.  Four resolutions
  408.                 are provided: 320x200, 640x480, 800x600, and 1024x768.
  409.      
  410.              *  Provides a built in selection of five methods to convert
  411.                 from TARGA to GIF.  Separate command line parameters are
  412.                 stored for each method, allowing very quick change over
  413.                 from one method to another.  Great for comparing the final
  414.                 product produced from several different methods.
  415.      
  416.              *  Calls your favorite text editor with the current .POV
  417.                 loaded.
  418.      
  419.              *  Calls your favorite image processor (IMPROCES, VGACAD,
  420.                 etc.), allowing you to perform post processing on your
  421.                 final pic files, or to create GIFs used for image mapping.
  422.      
  423.              *  Calls your favorite pic file viewer (VPIC, CSHOW, etc).
  424.                 So you can admire your GIFs (and show them off to your
  425.                 friends!).
  426.      
  427.              *  Calls a file browser program with all of your .POV files,
  428.                 sample .POVs, or INClude files loaded and ready to view.
  429.                 (Vern D. Burg's LIST.COM is highly recommended!)  Great for
  430.                 doing a quick search through the files provided with
  431.                 POV-Ray for reference.
  432.      
  433.              *  Calls your favorite hard disk manager program (Q-Dos,
  434.                 X-Tree, etc.).
  435.      
  436.      
  437.      THE FILES INCLUDED IN THE POVMenu ARCHIVE
  438.      ----------------------------------------------------------------------
  439.      The POVMNU11.ARJ archive should yield the following files:
  440.      
  441.            POVMENU.EXE  <-- The menu program.
  442.            POVMENU.V11  <-- Default config file, (renamed to POVMENU.CFG).
  443.           POVMHELP.DAT  <-- Online help text displayed by the menu program.
  444.           INSTPOVM.EXE  <-- Installation/Upgrade utility.
  445.              RUNPL.BAT  <-- Example user defined menu pick.
  446.            POVMENU.DOC  <-- The DOC file.
  447.             README.1ST  <-- Readme 1st information.
  448.              WHATS.NEW  <-- What's new in version 1.1.
  449.               DESC.SDI  <-- Description file (may be deleted).
  450.            FILE_ID.DIZ  <-- Description file (may be deleted).
  451.      
  452.      The POVMNU11.ARJ file was created using the ARJ security envelope feature.
  453.      When un-ARJing, the last line of text on your screen should say:
  454.      
  455.      *** This archive HAS a valid ARJ-SECURITY envelope ***
  456.      
  457.      If POVMenu was not packed in an ARJ file or ARJ doesn't report a clean file
  458.      when un-ARJing, you are urged to seek an original copy of the archive!
  459.      
  460.      
  461.  
  462.  
  463.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  7 
  464.      ======================================================================
  465.  
  466.  
  467.      A FEW THOUGHTS ABOUT INSTALLING POVMenu ON YOUR SYSTEM
  468.      ----------------------------------------------------------------------
  469.      The major bitch i got from most of the users of the version 1.0 release
  470.      was that your directory structure *HAD* to be changed to conform to
  471.      POVMenu's way of doing things.  The creation of this problem was
  472.      entirely my fault.  I did not make something clear enough in the
  473.      version 1.0 docs.
  474.      
  475.      POVMenu CAN BE CONFIGURED TO RUN IN ANY DIRECTORY STRUCTURE THAT YOU
  476.      PRESENTLY HAVE!  If it can't, then I have done a poor job as a
  477.      programmer, and I need your input to help fix it!
  478.      
  479.      In the following sections I will explain two strategies for
  480.      installing POVMenu.  The first, assumes that you currently have POV-
  481.      Ray installed on your hard drive, and that you have been using it for
  482.      some time now.  A few examples are given to help you with configuring
  483.      POVMenu to work in your existing setup.  The second strategy assumes
  484.      that you are a new comer to POV-Ray, and will be installing it for
  485.      the first time.  An example with step-by-step instructions is provided.
  486.      
  487.      Regardless of which strategy you will be using, a few basic steps are
  488.      required when installing.  These are:
  489.      
  490.          1)  Unpack the archive into the directory that POV-Ray runs in.
  491.      
  492.          2)  You *MUST* run the INSTPOVM installation utility.  This
  493.              programs installs your configuration file and creates the
  494.              POV.BAT file, that is critical to proper operation.
  495.      
  496.          3)  You must then run the menu program and fill in some
  497.              information on the configuration screens (ALT-F1 on the main
  498.              menu).
  499.      
  500.      Look through the next two sections and decide which one best describes
  501.      your needs, and follow the instructions given.
  502.      
  503.      
  504.      INSTALLING POVMenu IN AN EXISTING SETUP
  505.      ----------------------------------------------------------------------
  506.      In talking with some of the users of POV-Ray, I have found that the
  507.      directory structure people have varies wildly from person to person.
  508.      This complicates the design of a program like POVMenu if the user is
  509.      using more that one directory for ray tracing.  I will provide a few
  510.      concrete examples of how to install POVMenu into an existing directory
  511.      setup.
  512.      
  513.      EXAMPLE 1: Let's assume that you have every bloody file needed in one
  514.                 directory called \POV.  This means that all your include
  515.                 and dat files as well as all of the ray tracing software is
  516.                 in one directory.  Also, all of the image processors used
  517.                 to convert to GIF are here.  All of your TARGA files are
  518.                 created in this directory.  You get the picture...
  519.      
  520.                 The directory structure looks like this:
  521.      
  522.  
  523.  
  524.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  8 
  525.      ======================================================================
  526.  
  527.  
  528.                  \ROOT ----- \POV
  529.      
  530.      On the configuration screen fill in the blanks as follows:
  531.      
  532.                 |============== Path Names ============|
  533.                 2) POV-Ray Run Dir: \POV
  534.                 3) Scene File Dir : \POV
  535.                 4) Include FileDir: \POV
  536.                 5) Sample File Dir: \POV
  537.                 6) Image File Dir : \POV
  538.                 7)    Utility Dir : \POV
  539.      
  540.      Simple, no?  Ok, so what if I have just a few more directories in my
  541.      setup?
  542.      
  543.      EXAMPLE 2: Let's assume that you have you have a directory called \POV
  544.                 that holds the raytracer software and utilities.  Another
  545.                 that holds all of your samples, includes, and dat files
  546.                 called \DATS.  And a third one called \PICS that holds all
  547.                 of the TARGAs and GIFs that are created.  Lets take a look
  548.                 at this one...
  549.      
  550.                 The directory structure looks like this:
  551.      
  552.                  \ROOT ----- \POV --+-- \DATS
  553.                                     |
  554.                                     +-- \PICS
  555.      
  556.      On the configuration screen fill in the blanks as follows:
  557.      
  558.                 |============== Path Names ============|
  559.                 2) POV-Ray Run Dir: \POV
  560.                 3) Scene File Dir : \POV\DATS
  561.                 4) Include FileDir: \POV\DATS
  562.                 5) Sample File Dir: \POV\DATS
  563.                 6) Image File Dir : \POV\PICS
  564.                 7)    Utility Dir : \POV
  565.      
  566.      Are you starting to get the picture?  Ok, so what if a have several
  567.      directories, but they are all hung off of the root directory?  No
  568.      problem...
  569.      
  570.      EXAMPLE 3: Let's assume that you have you have a directory called \PVRAY
  571.                 that holds the raytracer software.  Another called \RAYUTIL
  572.                 that holds all of the utility stuff.  Another that
  573.                 holds all of your samples, includes, and dat files called
  574.                 \DAT.  And a forth one called \IMAGES that holds all of the
  575.                 TARGAs and GIFs that are created.  Lets take a look at this
  576.                 one...
  577.      
  578.                 The directory structure looks like this:
  579.      
  580.                  \ROOT --+-- \DAT
  581.                          |
  582.                          +-- \IMAGES
  583.  
  584.  
  585.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  9 
  586.      ======================================================================
  587.  
  588.  
  589.                          |
  590.                          +-- \PVRAY
  591.                          |
  592.                          +-- \RAYUTIL
  593.      
  594.      On the configuration screen fill in the blanks as follows:
  595.      
  596.                 |============== Path Names ============|
  597.                 2) POV-Ray Run Dir: \PVRAY
  598.                 3) Scene File Dir : \DAT
  599.                 4) Include FileDir: \DAT
  600.                 5) Sample File Dir: \DAT
  601.                 6) Image File Dir : \IMAGES
  602.                 7)    Utility Dir : \RAYUTIL
  603.      
  604.      See the sections about the configuration screen, as there are several
  605.      other fields that must be filled in before POVMenu will work properly.
  606.      
  607.      I hope this helps more that it confuses.  With just a little planning
  608.      and reading on your part, POVMenu can be made to run with any
  609.      directory setup.  Also, if you're still unsure what to put in the path
  610.      name fields, see the section that describes the specific purpose for
  611.      each of these paths (CONFIGURATIONS SCREEN OPTIONS).  If you still
  612.      don't know after reading that section, then call me!  I'd love to hear
  613.      from you.
  614.      
  615.      
  616.      INSTALLING POV-Ray AND POVMenu FROM SCRATCH
  617.      ----------------------------------------------------------------------
  618.      If you are a new comer to POV-Ray then this section should get you up
  619.      and going.  The recommended directory structure as defined in the POV-
  620.      Ray version 1.0 manual (page 10) is:
  621.      
  622.                        \ROOT --- \POVRAY --+-- \INCLUDE
  623.                                            |
  624.                                            +-- \SAMPLES
  625.                                            |
  626.                                            +-- \SCENES
  627.                                            |
  628.                                            +-- \UTIL
  629.      
  630.      You should have this directory structure established on your hard
  631.      drive and the various files installed as recommended in the POV-Ray
  632.      version 1.0 doc's before installing POVMenu.
  633.      
  634.      You should add one additional directory (IMAGES) to this configuration
  635.      to use POVMenu.  Your final directory structure should look like this:
  636.      
  637.                        \ROOT --- \POVRAY --+-- \IMAGES  <--- add this dir
  638.                                            |
  639.                                            +-- \INCLUDE
  640.                                            |
  641.                                            +-- \SAMPLES
  642.                                            |
  643.                                            +-- \SCENES
  644.  
  645.  
  646.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  10 
  647.      ======================================================================
  648.  
  649.  
  650.                                            |
  651.                                            +-- \UTIL
  652.      
  653.      Add the additional directory by moving to the '\POVRAY' directory and
  654.      typing the following command at the DOS prompt: 'MD IMAGES' and press
  655.      the [ENTER] key.
  656.      
  657.      Place the files from the POVMNU11.ARJ archive in the '\POVRAY'
  658.      directory.
  659.      
  660.      Run the INSTPOVM.EXE program.  When you run the INSTPOVM program it
  661.      will ask:
  662.      
  663.          Are you upgrading from a previous version of POVMenu (Y/N)?
  664.      
  665.      You should answer [N]o.  INSTPOVM will then asks a couple of questions
  666.      about the drive letter and directory name that POV-Ray is installed in.
  667.      This program writes the POV.BAT that calls the menu program.  After
  668.      running INSTPOVM, you should delete it, as there is no further need for
  669.      it.  The POV.BAT file created by INSTPOVM should look something like
  670.      this:
  671.      
  672.                  @ECHO OFF
  673.                  C:             <-- Hard drive POV-Ray is installed on
  674.                  CD \POVRAY     <-- Directory that POV-Ray is installed in
  675.                  POVMENU
  676.                  POVBAT
  677.      
  678.      
  679.      Make sure that the '\POVRAY' and the '\POVRAY\UTIL' directories are on
  680.      the DOS path and re-boot your system if needed.
  681.      
  682.      The last step in the installation procedure involves configuring
  683.      POVMenu for use in your environment.  Start POVMenu by typing 'POV'
  684.      at the DOS prompt and press [ENTER].  The menu should appear on your
  685.      screen.  Press ALT-F1 and the configuration screen should appear.
  686.      
  687.      One at a time, edit each of the field numbers shown below, and enter
  688.      the correct data for your system.  See the section on the CONFIGURATION
  689.      SCREEN OPTIONS for further details.
  690.      
  691.          1)  The name of the .POV file you would like to Edit/Render.
  692.      
  693.          8)  The name of the POV-Ray executable you are running.
  694.      
  695.          9)  The name of the image processing program used to 'touch up'
  696.              and add text to your final GIF files (IMPROCES or VGACAD).
  697.      
  698.         10)  Your favorite file browser (LIST.COM).
  699.      
  700.         11)  Your favorite GIF file viewer (VPIC or CShow).
  701.      
  702.         12)  The name of your favorite hard disk manager utility (QDos,
  703.              X-Tree, etc.).
  704.      
  705.  
  706.  
  707.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  11 
  708.      ======================================================================
  709.  
  710.  
  711.         13)  The name of your text editor (Qedit, Multi-Edit, etc.).
  712.      
  713.      Next, press [F1] while on the configuration screen, and you will be
  714.      presented with the convert to GIF options screen.  Select the desired
  715.      method by hi-lighting it and pressing [ENTER] and then press [ESCAPE].
  716.      
  717.      Press [ESCAPE] to save the configuration and exit.  After saving this
  718.      information, POVMenu is ready for use!
  719.      
  720.      The default configuration file supplied with POVMenu is setup to work
  721.      in the directory structure as defined in the POV-Ray docs.  All you
  722.      will need to do is fill in the PROGRAM NAME fields with the names of
  723.      the programs your using.
  724.      
  725.      
  726.      THE DIRECTORY STRUCTURE
  727.      ----------------------------------------------------------------------
  728.      If you are installing into the default directory structure as defined
  729.      in the POV_Ray docs, an explanation of the directories is in order.
  730.      The purpose of each directory is explained below:
  731.      
  732.      The '\POVRAY' directory contains the POV-Ray excitable, DOC files, and
  733.      other assorted goodies.  Install the INSTPOVM.EXE and POVMENU.EXE
  734.      files (from the archive) into this directory.
  735.      
  736.      The '\POVRAY\INCLUDE' directory should contain all the include
  737.      files in the version 1 release of POV-Ray. (i.e. COLORS.INC,
  738.      TEXTURES.INC, SHAPES.INC, etc...).
  739.      
  740.      -------------------
  741.      !! IMPORTANT TIP !!
  742.      -------------------
  743.      Any INCLUDE files that are defined in your .POV files *MUST* be
  744.      placed in the '\POVRAY\INCLUDE' directory, or POV-Ray will report an
  745.      error (include file not found).
  746.      
  747.      The '\POVRAY\SAMPLES' directory should contain all the sample
  748.      .POV files included in the version 1 release of POV-Ray.
  749.      
  750.      The '\POVRAY\SCENES' directory will hold all of the .POV files that
  751.      you create.
  752.      
  753.      The '\POVRAY\UTIL' directory should contain all the utility programs
  754.      and files in the version 1 release of POV-Ray.  You should also
  755.      install C-Render, C-Mapper, Coil, POVScape, and any other POV-Ray
  756.      utilities you may have.  Also, put all of your .BAT files that will
  757.      be installed as user defined menu picks in this directory.
  758.      
  759.      All of the TARGA, RAW, DUMP, and GIF files created during the
  760.      rendering and conversion processes will be placed in the '\POV\IMAGES'
  761.      directory.  This is also the directory that the image processing
  762.      programs are directed to run in.
  763.      
  764.      You may change the names of these directories to suit yourself (but
  765.      why bother?).  The above directory example is setup in the default
  766.  
  767.  
  768.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  12 
  769.      ======================================================================
  770.  
  771.  
  772.      configuration file that comes with POVMenu.  If you insist, you may
  773.      change the path names to anything that you like.  See the section
  774.      describing the CONFIGURATION SCREEN OPTIONS for further details.
  775.      
  776.      -------------------
  777.      !! IMPORTANT TIP !!
  778.      -------------------
  779.      MAKE SURE THAT THE '\POVRAY' DIRECTORY IS ON THE DOS PATH!  This is
  780.      necessary due to the manner in which the POVMenu program interacts
  781.      with the .BAT files that animate it.  See your DOS manual if you
  782.      don't know what the DOS 'path' is and how to set it up.
  783.      
  784.      
  785.      MENU OPERATION
  786.      ----------------------------------------------------------------------
  787.      POVMenu utilizes the '.DEF' feature in POV-Ray to pass the command line
  788.      parameters to the executable.  When any of the render options are
  789.      selected (F2, F3, & F6 thorough F9) a file named POVMENU.DEF is created
  790.      in the POV-Ray run directory, and all command line parameters are
  791.      written into this file.  Then, POV-Ray is called with the following
  792.      command line:
  793.      
  794.          [POV Executable Name] POVMENU.DEF
  795.      
  796.          Example: POVRAY POVMENU.DEF
  797.      
  798.      Note that this method will override any options set up in the
  799.      environment.  (i.e. SET POVRAYOPT=...).  See the section on the
  800.      DEFAULT PARAMETER FILE in the POV-Ray docs for further information on
  801.      how POV-Ray interacts with the .DEF file.
  802.      
  803.      POVMenu is launched from the DOS prompt by typing 'POV' and pressing
  804.      [ENTER].  The menu should appear on your screen.  Actions are selected
  805.      by pressing the 'F' key associated with the desired menu pick.
  806.      
  807.      A brief description of the menu functions are presented below:
  808.      
  809.      ------------------
  810.      F1 - EDIT POV file
  811.      ------------------
  812.      
  813.              Calls your text editor with the current .POV file loaded.
  814.              This file must be found in the directory specified in
  815.              configuration field 3 (Scene File Dir) or in \POVRAY\SAMPLES.
  816.      
  817.      ----------------------
  818.      F2 - QuickView 160x100
  819.      F3 - QuickView 320x200
  820.      ----------------------
  821.      
  822.              Calls POV-Ray with a command line causing the current .POV
  823.              file to be rendered directly to the screen using the internal
  824.              color selection that is built into the IBM port of POV-Ray.
  825.              The desired VGA chip set option may be specified on the
  826.              configuration screen, field 12 (QuickView display option).
  827.  
  828.  
  829.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  13 
  830.      ======================================================================
  831.  
  832.  
  833.      
  834.              I find these options useful when I'm working on a scene and
  835.              need to verify the basic shape, texture, and placement of the
  836.              objects I have defined in my .POV file.  The F2 option will
  837.              render a 160x100 picture (1/4 screen @320x200) and the F3
  838.              option will render a 320x200 picture (full screen).
  839.      
  840.              A sample command line used when calling POV for a QuickView
  841.              is available on the main configuration screen (press F3).
  842.      
  843.              IMPORTANT TIP:  With the release of version 1.0 of POV-Ray,
  844.              the render to screen will usually blow up when the QuickView
  845.              option is set to zero.  See the section that outlines this
  846.              function for more info!
  847.      
  848.      --------------------
  849.      F4 - Image Processor
  850.      --------------------
  851.      
  852.              Moves to the directory specified in configuration field 6
  853.              (Image File DIR) and calls the program defined in
  854.              configuration field 8 (Image Processor Pgm Name).  This is
  855.              handy when you need to touch-up a picture after conversion to
  856.              the final output format.  (Normally .GIF)
  857.      
  858.      --------------
  859.      F5 - View GIFs
  860.      --------------
  861.      
  862.              Moves to the directory specified in configuration field 6
  863.              (Image File DIR) and calls the program defined in configuration
  864.              field 10 (GIF Viewer Pgm Name).  Allows you to view all of your
  865.              wonderful raytraces!
  866.      
  867.      --------------------
  868.      F6 - Render 320x200
  869.      F7 - Render 640x480
  870.      F8 - Render 800x600
  871.      F9 - Render 1026x768
  872.      --------------------
  873.      
  874.              This group of menu picks will call POV-Ray with a command
  875.              line causing the current .POV file to be rendered to an
  876.              output file.  These picks are typically used to create your
  877.              final TARGA file.
  878.      
  879.              Note that several items on the configuration screen will
  880.              affect the command line passed to POV-Ray when rendering.
  881.              Field 16 (Anti-alias Y/N), field 15 (Anti-alias Threshold),
  882.              field 17 (Rendering Quality), and field 18 (POV Out File
  883.              Format).  See the POV docs on the command line options +a,
  884.              +q, and +f; and the section below (CONFIGURATION SCREEN
  885.              OPTIONS) for further information.
  886.      
  887.              The output file format during rendering is defined in
  888.  
  889.  
  890.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  14 
  891.      ======================================================================
  892.  
  893.  
  894.              configuration field 18 (POV Out File Format).  The 3 possible
  895.              formats are [t]arga, [r]aw, and [d]ump.  The only format
  896.              supported by POVMenu is the TARGA file format.  If your using
  897.              Raw or Dump, then the F10 pick (Convert to GIF) is useless.
  898.      
  899.              A sample of the command line used when calling POV-Ray for
  900.              final rendering my be displayed by pressing F3 while on
  901.              the configuration screen.
  902.      
  903.      --------------------
  904.      F10 - Convert to GIF
  905.      --------------------
  906.      
  907.              Most of the folks that are running the IBM port of POV-Ray are
  908.              using the GIF format as their final file format.  Because
  909.              POV-Ray will not output directly to GIF, the POV-Ray output
  910.              (TARGA) must be converted using a separate image processing
  911.              program capable of 24 bit TARGA to 8 bit GIF conversion.
  912.      
  913.              POVMenu supports five methods to convert from TARGA to GIF,
  914.              they are:
  915.      
  916.                      1)  TGA2GIF - Sun Country Software
  917.                      2)  CUTTGA  - Sun Country Software
  918.                      3)  PicLab  - Lee D. Crocker & Stone Soup
  919.                      4)  IMG2GIF - Steven Coy (with TGA2VIV by Dan Farmer)
  920.                      5)  ALCHEMY - Handmade Software
  921.      
  922.              The action taken when the F10 pick is asserted from the main
  923.              menu depends the method selected on the EDIT CONVERT TO GIF
  924.              OPTIONS screen.
  925.      
  926.              Please note that all image processing is carried out in the
  927.              directory specified in configuration field 6 (Image File Dir).
  928.              This is the directory that POV-Ray is instructed to build it's
  929.              TARGA files in, and is also the directory that the GIFs are
  930.              built in.  For this scheme to work, the image processor *MUST*
  931.              be on the DOS path or in the Image File Dir as specified in
  932.              configuration field 6.
  933.      
  934.              One final note about F10, if you are using another program to
  935.              do your conversion to GIF (besides the five listed), please
  936.              contact me and I'll be glad to add it to POVMenu.  The only
  937.              requirement is that the program must be able to accept it's
  938.              input from the DOS command line or via redirection from a
  939.              command file.
  940.      
  941.              A sample of the command line used when calling you Image
  942.              Processor for conversion to GIF my be displayed by pressing
  943.              F3 while on the main configuration screen.
  944.      
  945.      ------------------
  946.      ALT F1 - Configure
  947.      ------------------
  948.      
  949.  
  950.  
  951.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  15 
  952.      ======================================================================
  953.  
  954.  
  955.              Calls the configuration file editor.  See the section titled
  956.              "CONFIGURATION SCREEN OPTIONS" for further details.
  957.      
  958.      ------------------
  959.      ALT F2 - List POVs
  960.      ------------------
  961.      
  962.              Moves to the directory specified in configuration field 3
  963.              (Scene File Dir) and calls the program listed in
  964.              configuration field 9 (File Viewer Pgm Name).  This allows
  965.              you to move to the Scenes directory and view your .POV files
  966.              with LIST.
  967.      
  968.      ---------------------
  969.      ALT F3 - List SAMPLEs
  970.      ---------------------
  971.      
  972.              Moves to the directory specified in configuration field 5
  973.              (Sample File Dir) and calls the program listed in
  974.              configuration field 9 (File Viewer Pgm Name).  This allows
  975.              you to move to the Samples directory and view the sample
  976.              files supplied in POV-Ray with LIST.
  977.      
  978.      ----------------------
  979.      ALT F4 - List INCLUDEs
  980.      ----------------------
  981.      
  982.              Moves to the directory specified in configuration field 4
  983.              (INCLUDE File Dir) and calls the program listed in
  984.              configuration field 9 (File Viewer Pgm Name).  This allows
  985.              you to move to the Include file directory and view your
  986.              INCLUDE files with LIST.
  987.      
  988.      ---------------------
  989.      ALT F5 - Disk Utility
  990.      ---------------------
  991.      
  992.              Just about everyone has a favorite disk management utility
  993.              like QDos or X-Tree.  This menu pick transfers control to the
  994.              program specified in configuration field 11 (File Utility Pgm
  995.              Name).
  996.      
  997.              This allows you to copy files, move files, delete files, etc.
  998.              without having to exit the menu.
  999.      
  1000.      -----------------------------------------------
  1001.      ALT F6 thru ALT F10 - User Definable Menu Picks
  1002.      -----------------------------------------------
  1003.      
  1004.              Using the appropriate screen in the configuration system, you
  1005.              may install any options that you wish.  See the section on
  1006.              UTILITY CONFIGURATION for further information.
  1007.      
  1008.      
  1009.      
  1010.  
  1011.  
  1012.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  16 
  1013.      ======================================================================
  1014.  
  1015.  
  1016.      CONFIGURATION SCREEN OPTIONS
  1017.      ----------------------------------------------------------------------
  1018.      When you press ALT-F1 on the main menu you will be presented with the
  1019.      configuration screen.  This screen allows you to store a variety of
  1020.      information that determines how POV-Ray will work, what the current
  1021.      .POV file is, and the path names to the various directories used, etc.
  1022.      This information is written to disk, and is re-loaded each time POVMenu
  1023.      runs.  This means that the configuration settings are 'remembered' by
  1024.      the menu program.
  1025.      
  1026.      Each area on the configuration screens are divided into fields.  Each
  1027.      field is identified with a 'field number' that appears to the left of
  1028.      the field description and is delimited with the ')' character.  To
  1029.      change the contents of a field, enter the field number and press
  1030.      [ENTER].  The selected field will hi-lite and then you may enter
  1031.      information into the field.  Full edit capability is provided (i.e.
  1032.      insert, delete, home, end, etc.). Press [ENTER] when done.  The
  1033.      hi-lite will return to the prompt area, and the newly entered data
  1034.      will be displayed in the field.  When the hi-lite is in the prompt
  1035.      area, press [ESCAPE] to save the current settings and return to the
  1036.      Main Menu.
  1037.      
  1038.      The configuration editor is divided into three screens that you may
  1039.      enter information into, and a forth screen that displays the sample
  1040.      command lines.  Each of these four screens are described below:
  1041.      
  1042.      SCREEN 1 - THE MAIN CONFIGURATION
  1043.      ---------------------------------------------------------------------
  1044.      The main configuration screen has four areas where information is
  1045.      entered, and a help box.  Each area has it's own purpose.  The five
  1046.      areas are:
  1047.      
  1048.              1)  Current POV File
  1049.              2)  Path Names
  1050.              3)  Program Names
  1051.              4)  Rendering Options
  1052.              5)  The Help Box
  1053.      
  1054.      These five areas and their fields are explained in detail below:
  1055.      
  1056.      
  1057.      AREA 1 - CURRENT DATA FILE
  1058.      
  1059.      The fields are:
  1060.      
  1061.                          |====== Current Data File ======|
  1062.                          1) Current POV File: FLY.POV
  1063.      
  1064.      
  1065.              -------------------
  1066.              1) Current POV File
  1067.              -------------------
  1068.      
  1069.              Enter the name of the POV file that you wish to edit and
  1070.              render here.  This is the file name that will be passed to
  1071.  
  1072.  
  1073.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  17 
  1074.      ======================================================================
  1075.  
  1076.  
  1077.              your editor for the F1 (Edit POV File) menu pick.  This is
  1078.              also the input file name passed on the command line when doing
  1079.              a quickview or render.
  1080.      
  1081.              The file name specified here is first looked for in the
  1082.              SAMPLES directory.  If not found there, then POVMenu looks in
  1083.              the SCENES directory.  If the specified file is not found
  1084.              there, then it is assumed you are starting a new .POV file.
  1085.              You are prompted if you wish to create the new file.  If you
  1086.              answer YES, then a new file is created in the SCENES
  1087.              directory and it will contain a single comment line
  1088.              indicating the new file name.  You may then edit, quickview,
  1089.              and render as desired.
  1090.      
  1091.              Defaults to "CHANGEME.POV" until changed.
  1092.      
  1093.      
  1094.      AREA 2 - PATH NAMES
  1095.      
  1096.      The fields are:
  1097.      
  1098.                        |============== Path Names ============|
  1099.                        2) POV-Ray Run Dir: \POVRAY
  1100.                        3) Scene File Dir : \POVRAY\SCENES
  1101.                        4) Include FileDir: \POVRAY\INCLUDE
  1102.                        5) Sample File Dir: \POVRAY\SAMPLES
  1103.                        6) Image File Dir : \POVRAY\IMAGES
  1104.                        7)    Utility Dir : \POVRAY\UTIL
  1105.      
  1106.              ------------------
  1107.              2) POV-Ray Run Dir
  1108.              ------------------
  1109.      
  1110.              Enter the full path name to the directory where the POV-Ray
  1111.              excitable may be found.
  1112.      
  1113.              Defaults to '\POVRAY' if not changed.
  1114.      
  1115.              -----------------
  1116.              3) Scene File Dir
  1117.              -----------------
  1118.      
  1119.              Enter the full path name to the directory where the .POV
  1120.              files created by are kept.
  1121.      
  1122.              Defaults to '\POVRAY\SCENES' if not changed.
  1123.      
  1124.              -------------------
  1125.              4) Include File Dir
  1126.              -------------------
  1127.      
  1128.              Enter the  full path  name to  the directory  where your
  1129.              include files may be found (i.e. COLORS.INC, SHAPES.INC,
  1130.              TEXTURE.INC etc...).
  1131.      
  1132.  
  1133.  
  1134.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  18 
  1135.      ======================================================================
  1136.  
  1137.  
  1138.              Defaults to '\POVRAY\INCLUDE' if not changed.
  1139.      
  1140.              -----------------
  1141.              6) Image File Dir
  1142.              -----------------
  1143.      
  1144.              Enter the full path name to the directory where all output
  1145.              image files will be built when created by POV-Ray.  This is
  1146.              the directory where your TARGA files will be created when
  1147.              rendering a final image.
  1148.      
  1149.              Defaults to '\POVRAY\IMAGES' if not changed.
  1150.      
  1151.              NOTE: This directory is created by you when installing POVMenu.
  1152.      
  1153.              --------------
  1154.              7) Utility Dir
  1155.              --------------
  1156.      
  1157.              Enter the full path name to the directory where all utility
  1158.              processing is performed.  Whenever any of the main menu picks
  1159.              ALT-F6 through ALT-F10 are selected, processing is carried out
  1160.              in this directory.
  1161.      
  1162.              Defaults to '\POVRAY\UTIL' if not changed.
  1163.      
  1164.      AREA 3 - PROGRAM NAMES
  1165.      
  1166.      The fields are:
  1167.      
  1168.                         |========== Program Names ==========|
  1169.                         8) POV-Ray Executable Name: POVIBM
  1170.                         9) Image Processor Pgm Name: IMPROCES
  1171.                        10) File Viewer Pgm Name    : LIST
  1172.                        11) GIF Viewer Pgm Name     : VPIC
  1173.                        12) File Utility Pgm Name   : QD
  1174.                        13) Text Editor Pgm Name    : Q
  1175.      
  1176.              ---------------------------
  1177.              8) POV-Ray Excitable Name
  1178.              ---------------------------
  1179.      
  1180.              Enter the name of the POV excitable that you are using
  1181.              here.  This is the program name specified on the command line
  1182.              when POVMenu calls POV-Ray to render or quickview.
  1183.      
  1184.              Defaults to 'POVRAY' if not changed.
  1185.      
  1186.              ---------------------------
  1187.              9) Image Processor Pgm Name
  1188.              ---------------------------
  1189.      
  1190.              Enter the name of your image processing program here.  This
  1191.              is the program that will be called when the F4 (Image
  1192.              Processor) menu pick is selected.  POVMenu will move to the
  1193.  
  1194.  
  1195.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  19 
  1196.      ======================================================================
  1197.  
  1198.  
  1199.              path  specified in  field  6  and  then  call  the  program
  1200.              name entered in field 9.
  1201.      
  1202.              Defaults to 'IMPROCES' if not changed.
  1203.      
  1204.              ------------------------
  1205.              10) File Viewer Pgm Name
  1206.              ------------------------
  1207.      
  1208.              Enter the name of the file browser utility that you wish to
  1209.              use here.  This name is passed on the command line when the
  1210.              ALT-F2, ALT-F3, ALT-F4 (List POVs, SAMPLES, INCLUDES) menu
  1211.              picks are selected.
  1212.      
  1213.              Defaults to 'LIST' if not changed.
  1214.      
  1215.              -----------------------
  1216.              11) GIF Viewer Pgm Name
  1217.              -----------------------
  1218.      
  1219.              Enter the name of your favorite GIF file viewer utility here.
  1220.              This name is passed on the command line when the F5 (View
  1221.              GIFs) menu pick is selected.
  1222.      
  1223.              Defaults to 'VPIC' if not changed.
  1224.      
  1225.              -------------------------
  1226.              12) File Utility Pgm Name
  1227.              -------------------------
  1228.      
  1229.              Enter the name of your favorite hard disk management utility
  1230.              here (such as Qdos or Xtree).  This program name is called
  1231.              when the ALT-F5 menu pick is selected.
  1232.      
  1233.              Defaults to 'QD' (i.e. QDos) if not changed.
  1234.      
  1235.              ------------------------
  1236.              13) Text Editor Pgm Name
  1237.              ------------------------
  1238.      
  1239.              Enter the name of your favorite text editor here.  This is
  1240.              the program specified when the F1 (Edit POV file) menu pick
  1241.              is selected.
  1242.      
  1243.              Defaults to 'Q' (i.e. Qedit) if not changed.
  1244.      
  1245.      
  1246.      AREA 4 - RENDERING OPTIONS
  1247.      
  1248.      The fields are:
  1249.      
  1250.                            |===== Rendering Options ======|
  1251.                            14)  Anti-alias T-hold: 0.2
  1252.                            15) Use Anti-alias Y/N: Y
  1253.                            16)  Rendering Quality: 9
  1254.  
  1255.  
  1256.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  20 
  1257.      ======================================================================
  1258.  
  1259.  
  1260.                            17)  QView Display Opt: 0
  1261.                            18) POV Out File Formt: targa
  1262.                            19) Allow break during
  1263.                                Rendering (Y/N)   : N
  1264.      
  1265.              ---------------------
  1266.              14) Anti-alias T-hold
  1267.              ---------------------
  1268.      
  1269.              If field 16 is set to Yes, the value entered here is passed
  1270.              as the anti-alias threshold when rendering (i.e. +a0.2).  See
  1271.              the POV-Ray docs for further info on the +a command line option.
  1272.      
  1273.              Defaults to '0.2' if not changed.
  1274.      
  1275.              ------------------
  1276.              15) Anti-alias Y/N
  1277.              ------------------
  1278.      
  1279.              This Yes/No question determines whether or not anti-aliasing
  1280.              will be in effect when rendering (F2, F3, and F6 through F9
  1281.              on the menu).  See the POV-Ray docs for further info on the
  1282.              -a/+a command line parameters.
  1283.      
  1284.              Defaults to 'No' if not changed.
  1285.      
  1286.              ------------------
  1287.              16) Render Quality
  1288.              ------------------
  1289.      
  1290.              This field determines the value passed in the -q parameter
  1291.              on the command line when rendering.  The valid entries are
  1292.              numeric one through nine (1-9).  See the POV-Ray doc's for
  1293.              further info on the -q command line parameter.
  1294.      
  1295.              Defaults to '9' if not changed.
  1296.      
  1297.              ----------------------------
  1298.              17) QuickView Display Option
  1299.              ----------------------------
  1300.      
  1301.              This option requires a little explanation.  There were several
  1302.              new display modes added in version 1.0 of POV-Ray, and for
  1303.              some unknown reason, the +d options were not documented in the
  1304.              POV-Ray version 1.0 docs.
  1305.      
  1306.              The +d command line option allows you to define the video
  1307.              hardware and palette in use when rendering directly to the
  1308.              screen.  The +d option takes the form of: +dxy, where x is
  1309.              the display adapter type and y is the palette option.  POVMenu
  1310.              allows you to define the display option in the following field:
  1311.      
  1312.              17)  QView Display Opt: xy
  1313.      
  1314.              All of the information that I am quoting below came from Tim
  1315.  
  1316.  
  1317.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  21 
  1318.      ======================================================================
  1319.  
  1320.  
  1321.              Wegner's wonderful book: "Image Lab" (pg. 308), published by
  1322.              The Waite Group (ISBN 1-878739-11-5, $39.95 and highly
  1323.              recommended!).
  1324.      
  1325.              The valid values for x (display adapter type) are:
  1326.      
  1327.                      0 - (Default) Auto-detect from types below
  1328.                      1 - Basic, plain vanilla VGA 320x200
  1329.                      2 - MVGA (mode 13X) Tweaked VGA 360x480, if >320x200
  1330.                      3 - Tesing Labs 3000 SVGA
  1331.                      4 - Tesing Labs 4000 SVGA
  1332.                      5 - AT&T VDC600 SVGA
  1333.                      6 - Oak Technologies OTI-067
  1334.                      7 - Video 7 SVGA
  1335.                      8 - Video 7 Vega VGA
  1336.                      9 - Paradise SVGA
  1337.                      A - Ahead Systems Version 'A' SVGA
  1338.                      B - Ahead Systems Version 'B' SVGA
  1339.                      C - Chips & Technologies SVGA
  1340.                      D - ATI VGA Wonder
  1341.                      E - Everex SVGA
  1342.                      F - Trident SVGA
  1343.                      G - VESA standard SVGA
  1344.            H through N - Reserved, unassigned (S)VGA types
  1345.      
  1346.                      O - TIGA/Hercules Graphics Workstation 16-bit
  1347.                      P - TIGA/Hercules Graphics Workstation 32-bit
  1348.            Q through Z - Reserved, unassigned True-Color adapter types
  1349.      
  1350.      
  1351.              The valid values for y (palette options) are:
  1352.      
  1353.                      0 - (Default) HSV->RGB method
  1354.                      3 - 3-3-2 RGB method
  1355.                      G - Grey Scale (optimized 64-shade palette for IBM's)
  1356.                      H - Serra High Color palette DAC
  1357.      
  1358.              The character(s) entered here are used to build the display
  1359.              command line specification when the F2 & F3 (QuickView) menu
  1360.              picks are selected.  See the POV-Ray docs for further info on
  1361.              the +d command line parameter (what little there is!).
  1362.              Defaults to 0 (zero, auto-detect and HSV palette) if not
  1363.              changed.
  1364.      
  1365.              -------------------
  1366.              !! IMPORTANT TIP !!
  1367.              -------------------
  1368.              With the release of version 1.0 of POV-Ray, when the Display
  1369.              Option is set to zero, POV-Ray will report a run-time error
  1370.              when rendering to the screen, (most of the time).  If POV-Ray
  1371.              will render to a Targa file, but bombs out when you try to do
  1372.              a QuickView, the you need to change the option defined in
  1373.              this field to match the chip set in your VGA card.
  1374.      
  1375.              Defaults to 0 (zero, auto-detect and HSV palette) if not
  1376.  
  1377.  
  1378.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  22 
  1379.      ======================================================================
  1380.  
  1381.  
  1382.              changed.  PLEASE CHANGE THIS WHEN INSTALLING!!
  1383.      
  1384.              --------------------------
  1385.              18) POV Output File Option
  1386.              --------------------------
  1387.      
  1388.              The parameter entered here will determine the file format that
  1389.              your final product will be rendered in.  See the POV docs for
  1390.              further info on the +f command line option.
  1391.      
  1392.              Defaults to 't' (TARGA) if not changed.
  1393.      
  1394.              Note that the TARGA format is the only output file format
  1395.              supported by the F10 (Convert to GIF) menu pick.
  1396.      
  1397.              --------------------------------------
  1398.              19) Allow BREAK during rendering (Y/N)
  1399.              --------------------------------------
  1400.      
  1401.              Setting this option to [Y]es will cause the +x parameter to
  1402.              be passed to POV-Ray when rendering.  This allows you to abort
  1403.              a trace while POV-Ray is rendering.  Setting this option to
  1404.              [N]o, locks the in the trace until POV-Ray is finished. (The
  1405.              only way to break is to RESET your computer.)
  1406.      
  1407.              Defaults to 'N' if not changed.
  1408.      
  1409.              ------------------------------------------
  1410.              20) QuickView to Video While Rendering Y/N
  1411.              ------------------------------------------
  1412.      
  1413.              Setting this option to [Y]es will cause the +d parameter to
  1414.              be passed to POV-Ray when rendering.  This allows you to view
  1415.              the trace directly on the screen as it is rendered to a file.
  1416.              Also, note that when enabled, the -v command line parameter
  1417.              will be passed to prevent the stats display while rendering.
  1418.      
  1419.              Defaults to 'N' if not changed.
  1420.      
  1421.              -------------
  1422.              !! WARNING !!    (You better read this!)
  1423.              -------------
  1424.              Be advised that when this option is enabled, POV-Ray will switch
  1425.              the video into graphics mode and set the resolution to match the
  1426.              image being rendered.  If you are rendering in a SVGA resolution
  1427.              like 800x600 or 1024x768, POV-Ray will attempt to switch your VGA
  1428.              card into those modes.  If your display monitor can not handle
  1429.              these modes, it will most likely self-destruct (i.e. smoke will
  1430.              come out!).  DO NOT ENABLE THIS OPTION UNLESS YOU ARE QUITE SURE
  1431.              THAT YOUR MONITOR WILL SAFELY DISPLAY THE RESOLUTION THAT YOU
  1432.              ARE RENDERING AT.  YOU HAVE BEEN WARNED!
  1433.      
  1434.              -----------------------
  1435.              21) Verbose Display Y/N
  1436.              -----------------------
  1437.  
  1438.  
  1439.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  23 
  1440.      ======================================================================
  1441.  
  1442.  
  1443.      
  1444.              Setting this option to [Y]es will cause the +v parameter to
  1445.              be passed to POV-Ray when rendering.  This causes POV-Ray to
  1446.              display statistics while rendering.
  1447.      
  1448.              Defaults to 'Y' if not changed.
  1449.      
  1450.      
  1451.      AREA 5 - THE HELP BOX
  1452.      
  1453.      At the bottom of the screen is a box that displays the options
  1454.      available on the configuration screen, and also contains the prompt
  1455.      area.  The help box is shown below:
  1456.      
  1457.           +-[ POVMenu Configuration ]-----------------------------------+
  1458.           |                                                             |
  1459.           |  Press: F1 to edit CONVERT TO GIF OPTIONS                   |
  1460.           |         F2 to edit UTILITY OPTIONS                          |
  1461.           |         F3 to VIEW SAMPLE COMMAND LINES                     |
  1462.           |                         -or-                                |
  1463.           |         Enter the FIELD NUMBER (above) to change -->        |
  1464.           |         [ESCAPE] to save current settings and EXIT          |
  1465.           +-------------------------------------------------------------+
  1466.      
  1467.       When the cursor is in the prompt box, you may enter the field
  1468.      number that you wish to edit and press [ENTER].  Or, you may press the
  1469.      3 listed 'F' keys to gain access to more configuration options.
  1470.      
  1471.      The three screens available with F1, F2, and F3 are explained below:
  1472.      
  1473.      
  1474.      SCREEN 2 - (F1) CONVERT TO GIF OPTIONS
  1475.      ---------------------------------------------------------------------
  1476.      Because POV-Ray will not output directly to GIF, the POV-Ray output
  1477.      (TARGA) must be converted using a separate image processing program
  1478.      capable of 24 bit TARGA to 8 bit GIF conversion.  POVMenu supports
  1479.      five methods to convert from TARGA to GIF, they are:
  1480.      
  1481.              TGA2GIF by Sun Country Software
  1482.              CUTTGA  by Sun Country Software
  1483.              PICLAB  by Lee Daniel Crocker & The Stone Soup Group
  1484.              IMG2GIF by Steven Coy (with TGA2VIV by Dan Farmer)
  1485.              ALCHEMY by Handmade Software (Image Alchemy)
  1486.      
  1487.      To access the CONVERT TO GIF OPTIONS, press [F1] while on the main
  1488.      configuration screen.  The screen is divided into two areas.  The
  1489.      upper area provides on-line help describing the currently hi-lighted
  1490.      program and explains how POVMenu uses it to perform a convert to GIF
  1491.      operation.  The text in this area will change as you move the hi-light
  1492.      up and down in the selection box.
  1493.      
  1494.      The lower area of the screen has a selection box to the right that
  1495.      contains the 5 convert methods.  One of the selections will be
  1496.      hi-lighted.  You may change your selection by pressing the UP or
  1497.      DOWN arrows until the desired method is hi-lighted, and then press
  1498.  
  1499.  
  1500.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  24 
  1501.      ======================================================================
  1502.  
  1503.  
  1504.      [ENTER].
  1505.      
  1506.      The area to the left displays your current selection, and the command
  1507.      line options for the conversion method.  Press [F1] to edit the command
  1508.      line options.  Full edit capability is provided (i.e. insert, delete,
  1509.      home, end, etc.). Press [ENTER] when done.  The hi-lite will return to
  1510.      the selection box, indicating that the edit operation is complete.
  1511.      The options entered here will be passed on the command line when the
  1512.      image processor is called by the CONVERT-TO-GIF menu pick (F10 on the
  1513.      Main Menu).
  1514.      
  1515.      Note that as you scroll up and down in the list of conversion methods,
  1516.      the command line options will change.  POVMenu stores a separate set
  1517.      of command line options for each conversion method.  This allows you
  1518.      to change from one method to another very quickly when selecting a
  1519.      conversion program.
  1520.      
  1521.      After you gain some experience rendering images with POV-Ray, and
  1522.      then converting the Targa files to GIFs, you will find the results
  1523.      that each conversion method gives will vary.  Alchemy may do a better
  1524.      job with a given image that PicLab or IMG2GIF.  Other images will
  1525.      convert better with PicLab or TGA2GIF, or one of the other methods.
  1526.      This will require some experimentation on your part to decide which
  1527.      conversion method yields the best results.  This is due to the
  1528.      various dithering methods that the image processors use to reduce
  1529.      millions of colors that may be present in a Targa file down to
  1530.      just 256 colors (the maximum number of colors that can be displayed
  1531.      on a standard SVGA is 256).
  1532.      
  1533.      I have arranged the menu system to allow you to change the conversion
  1534.      method very quickly in an effort to allow you to compare the various
  1535.      image processors when converting your final render to a GIF.
  1536.      
  1537.      Generally speaking, when I have rendered a picture, I will first
  1538.      convert it with Image Alchemy.  Alchemy tends to give me the best
  1539.      results in most cases.  I will use this picture as a reference, and
  1540.      then convert using PicLab, IMG2GIF, and TGA2GIF and compare the
  1541.      resulting images one at a time.
  1542.      
  1543.      The manner in which POVMenu calls the image processors to convert to
  1544.      GIF and a little background on each of these programs is outlined
  1545.      below:
  1546.  
  1547.  
  1548.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  25 
  1549.      ======================================================================
  1550.  
  1551.  
  1552.      
  1553.      
  1554.      -------------
  1555.      IMAGE ALCHEMY
  1556.      -------------
  1557.      
  1558.              When POVMenu calls Image Alchemy the following action is taken.
  1559.              A command line is built that contains the following elements:
  1560.      
  1561.              [GIF Conversion Pgm Name] + [POVFILE.TGA] + [POVFILE.GIF]
  1562.              + [GIF Conversion Options]
  1563.      
  1564.              Example: ALCHEMY MYFILE.TGA MYFILE.GIF -o -ds -8 -256
  1565.                       ^^^^^^^ ^^^^^^     ^^^^^^     ^^^^^^^^^^^^^^
  1566.                          |      |           |              |
  1567.                          |      +-----+-----+              |
  1568.                          |            |                    |
  1569.              Cvt-to-GIF option  Config field 1     Alchemy Cmd Parameters
  1570.      
  1571.              This command line is written into a batch file and control
  1572.              is transferred to this batch file, causing ALCHEMY to convert
  1573.              the TARGA file to a GIF file.  When ALCHEMY terminates, control
  1574.              returns to POVMenu, and the Main menu re-appears on your screen.
  1575.      
  1576.      ABOUT IMAGE ALCHEMY:
  1577.      ALCHEMY is a shareware conversion program by Handmade Software, Los
  1578.      Gatos, CA.  ALCHEMY does an excellent job of converting from Targa to
  1579.      GIF.  POVMenu runs ALCHEMY by writing a series of commands into a batch
  1580.      file and then transfers control to it.  ALCHEMY performs a direct
  1581.      conversion from Targa to GIF.
  1582.      
  1583.      COMMAND LINE OPTIONS:
  1584.      ALCHEMY provides a very flexible command line allowing control over
  1585.      palette selection method & sort, dither type, etc.  Several dithers
  1586.      are available: -d1 Floyd-Steinberg, -d2 Stucki, & -d3 Jarvis-Judice
  1587.      -Ninke.  Generally, a parameters setting of:  -o -g -ds -8 -c256 will
  1588.      give good results.  Please see the ALCHEMY docs for further info.
  1589.  
  1590.  
  1591.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  26 
  1592.      ======================================================================
  1593.  
  1594.  
  1595.      
  1596.      
  1597.      ------
  1598.      PICLAB
  1599.      ------
  1600.      
  1601.              When POVMenu calls PicLab the following action is taken. First
  1602.              of all, a command file is created which contains the proper
  1603.              commands and filenames that will cause PicLab to convert the
  1604.              desired TARGA file to a GIF.  When PicLab is called, it is
  1605.              directed to accept it's input from the command file.
  1606.      
  1607.              The PicLab command file is named POVMENU.CMD and looks
  1608.              something like this:
  1609.      
  1610.                      TLOAD MYFILE.TGA  <-- load input TARGA file
  1611.                      MAKEPAL           <-- build GIF color palette
  1612.                      MAP               <-- map the new palette
  1613.                      GSAVE MYFILE.GIF  <-- save the image to a GIF
  1614.                      QUIT              <-- all done!
  1615.      
  1616.              Next, a command line is built that contains the following
  1617.              elements:
  1618.      
  1619.              [GIF Conversion Pgm Name] + "POVMENU.CMD"
  1620.      
  1621.              Example: PL POVMENU.CMD
  1622.                       ^^ ^^^^^^^^^^^
  1623.                       |      |
  1624.                       |      +--- Hard wired in POVMenu
  1625.              Cvt-to-GIF option
  1626.      
  1627.              This command line is written into a batch file and control is
  1628.              transferred to this batch file, causing PicLab to read it's
  1629.              input from the file POVMENU.CMD.  You will be able to watch
  1630.              PicLab run as it goes through the motions of converting the
  1631.              file.  When PicLab terminates, control returns to POVMenu, and
  1632.              the Main menu re-appears on your screen.
  1633.      
  1634.      ABOUT PICLAB:
  1635.      PicLab is a public domain image processor by Lee Daniel Crocker.  It
  1636.      is suitable for converting from Targa to GIF.  POVMenu uses the
  1637.      "Command File" feature in PicLab to pass processing commands.  POVMenu
  1638.      writes a series of commands into a file called POVMENU.CMD, and then
  1639.      calls PicLab with the following command line:  PL POVMENU.CMD  This
  1640.      causes PicLab to read it's commands from the POVMENU.CMD file instead
  1641.      of from the keyboard.  PicLab converts directly from Targa to GIF.
  1642.      
  1643.      COMMAND LINE OPTIONS:
  1644.      No command options are needed when using PicLab.  Please see the PicLab
  1645.      docs for further information.
  1646.  
  1647.  
  1648.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  27 
  1649.      ======================================================================
  1650.  
  1651.  
  1652.      
  1653.      
  1654.      -------
  1655.      IMG2GIF
  1656.      -------
  1657.      
  1658.              When POVMenu calls IMG2GIF the following action is taken.
  1659.              First of all, a BAT file is created which contains the proper
  1660.              commands and filenames that will cause the conversion of the
  1661.              desired TARGA file to a GIF.
  1662.      
  1663.              The controlling BAT file looks something like this:
  1664.      
  1665.                  @ECHO OFF
  1666.                  CLS
  1667.                  CD \POVRAY\IMAGES
  1668.                  CALL TGA2VIV BLOCK          <-- Convert from Targa to IMG
  1669.                  CALL IMG2GIF BLOCK -d -m    <-- Convert from IMG to GIF
  1670.                  IF EXIST *.IMG DEL *.IMG    <-- Clean up the disk
  1671.                  PAUSE
  1672.                  POV
  1673.      
  1674.              Note that the line that calls IMG2GIF works like this:
  1675.      
  1676.                  CALL IMG2GIF BLOCK -d -m
  1677.                       ^^^^^^^ ^^^^^ ^^^^^
  1678.                          |      |     |
  1679.                          |      |     +-- IMG2GIF command parameters
  1680.              Cvt-to-GIF option  +-- Config Field 1 (.POV file name)
  1681.      
  1682.              This command line is written into the batch file and control
  1683.              is transferred to this batch file, causing the conversion from
  1684.              Targa to GIF.
  1685.      
  1686.      ABOUT IMG2GIF:
  1687.      IMG2GIF is a conversion utility by Steven Croy (author of Vivid).
  1688.      IMG2GIF does an excellent job of converting to the GIF format.
  1689.      Conversion using this program is a two step process.  First the Targa
  1690.      file is converted to the IMG format using TGA2VIV (by Dan Farmer).  It
  1691.      is then converted to GIF using IMG2GIF.  POVMenu writes a series of
  1692.      commands into a batch file and then transfers control to it.  Both
  1693.      programs run sequentially, causing the conversion to GIF.
  1694.      
  1695.      COMMAND LINE OPTIONS:
  1696.      Note that the information in Parameters are passed as parameters to
  1697.      IMG2GIF when it runs.  The -d parameter selects a Floyd-Steinberg
  1698.      dither.  Also available are: -o ordered dither, -r random noise, and
  1699.      -m median cut.  Generally, a parameters setting of:  -d -m  will give
  1700.      good results.  Please see the IMG2GIF docs for further information.
  1701.  
  1702.  
  1703.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  28 
  1704.      ======================================================================
  1705.  
  1706.  
  1707.      
  1708.      
  1709.      -------
  1710.      TGA2GIF
  1711.      -------
  1712.      
  1713.              When POVMenu calls TGA2GIF the following action is taken.  A
  1714.              command line is built that contains the following elements:
  1715.      
  1716.              [GIF Conversion Pgm Name] + [GIF Conversion Options]
  1717.              + [POVFILE.TGA] + [POVFILE.GIF]
  1718.      
  1719.              Example: TGA2GIF -d MYFILE.TGA MYFILE.GIF
  1720.                       ^^^^^^^ ^^ ^^^^^^     ^^^^^^
  1721.                          |     |   |           |
  1722.                          |     |   +-----+-----+
  1723.                          |     |         |
  1724.              Cvt-to-GIF option |         +-- Config field 1
  1725.                                +-- TGA2GIF command line parameters
  1726.      
  1727.              This command line is written into a batch file and control
  1728.              is transferred to this batch file, causing TGA2GIF to convert
  1729.              the TARGA file to a GIF file.  When TGA2GIF terminates, control
  1730.              returns to POVMenu, and the Main menu re-appears on your screen.
  1731.      
  1732.      ABOUT TGA2GIF:
  1733.      TGA2GIF is a new shareware conversion program by Sun Country Software,
  1734.      Albuquerque, NM.  TGA2GIF does an excellent job of converting from Targa
  1735.      to GIF.  POVMenu runs TGA2GIF by writing a series of commands into a
  1736.      batch file and then transfers control to it.  TGA2GIF performs a direct
  1737.      conversion from Targa to GIF.
  1738.      
  1739.      COMMAND LINE OPTIONS:
  1740.      Note that the information in Parameters are passed as the flags to
  1741.      TGA2GIF when it runs.  The /d flag specifies an optional dither using
  1742.      Floyd-Steinberg.  Generally, a parameters setting of: /d  will give
  1743.      good results.  Please see the TGA2GIF docs for further information.
  1744.      
  1745.      ------
  1746.      CUTTGA
  1747.      ------
  1748.      Support for Sun Country Software's CUTTGA is provided based on some
  1749.      preliminary information provided by Loren Bolinger at Sun Country.  As
  1750.      this version of POVMenu went to press I had not received an evaluation
  1751.      copy of CUTTGA to verify proper operation with.  Based on the
  1752.      information that I got from Loren, this convert method should work
  1753.      fine, but I have no way of verifying this.
  1754.      
  1755.  
  1756.  
  1757.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  29 
  1758.      ======================================================================
  1759.  
  1760.  
  1761.      SCREEN 3 - (F2) UTILITY CONFIGURATION (The User Definable Menu Picks)
  1762.      ---------------------------------------------------------------------
  1763.      POVMenu provides you with 5 user definable menu picks.  You may install
  1764.      any POV-Ray utilities or user written BAT files that you wish.  This
  1765.      allows you to adapt POVMenu to your liking, and add functions that are
  1766.      unique to your working environment.
  1767.      
  1768.      When you press [F2] while on the main configuration screen, the Utility
  1769.      Configuration screen will appear.  This screen is divided into three
  1770.      areas:  The upper area provides a help text.  The lower left area has
  1771.      5 fields that contains the names of the programs and/or user written
  1772.      BAT files the will be run by POVMenu when selected.  The lower right
  1773.      area contains the text that will displayed on the menu for the menu
  1774.      pick names.
  1775.      
  1776.      Note that the fields on this screen are paired up.  Field 1 is the
  1777.      program or BAT file name for the first menu pick, and Field 6 is
  1778.      the menu pick name that is displayed on the Main Menu.
  1779.      
  1780.      -----------------
  1781.      !!IMPORTANT TIP!!
  1782.      -----------------
  1783.      When POVMenu runs one of the user defined utility programs, it changes
  1784.      to the directory specified in configuration field 7 (Utility
  1785.      Directory, which is normally set to '\POVRAY\UTIL'), and then attempts
  1786.      to run the program or batch file.  This means that the program or batch
  1787.      file called by POVMenu must be in the utility directory or on the DOS
  1788.      path.
  1789.      
  1790.      POVMenu comes with one utility program installed, to provide an example
  1791.      of how to use this feature.  You will note that the ALT-F6 menu pick
  1792.      calls PicLab.  Let's take a look at how this works...
  1793.      
  1794.      To install PicLab as a menu pick, I first created a little batch file
  1795.      called RUNPL.BAT in the \POVRAY\UTIL directory.  RUNPL.BAT looks like
  1796.      this:
  1797.      
  1798.              @ECHO OFF
  1799.              CD\POVRAY\IMAGES
  1800.              PL
  1801.      
  1802.      Note that the batch file changes to the \POVRAY\IMAGES directory
  1803.      before it run PicLab (I have PicLab installed in the IMAGES directory).
  1804.      
  1805.      Then to actually install the menu pick, I went to the UTILITY
  1806.      CONFIGURATION screen (F2 from the Configuration Screen) and entered
  1807.      'RUNPL' in field 1, and entered 'PicLab' in field 6.
  1808.      
  1809.      This feature adds a lot of flexibility to POVMenu by allowing you
  1810.      to add functions to the menu that suit your personal needs.
  1811.      
  1812.  
  1813.  
  1814.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  30 
  1815.      ======================================================================
  1816.  
  1817.  
  1818.      SCREEN 4 - (F3) SAMPLE COMMAND LINE DISPLAY
  1819.      ---------------------------------------------------------------------
  1820.      POVMenu provides you with a screen that displays a sample of the
  1821.      command lines used when rendering to the screen, rendering to file,
  1822.      and when converting to GIF.  When you press [F3] while at the main
  1823.      configuration screen, the Sample Command Line Display screen will
  1824.      appear.  This screen is divided into two sections.  The upper area
  1825.      displays a help text, the lower area displays the three sample
  1826.      command lines.
  1827.      
  1828.      POVMenu uses the '.DEF' file method of passing command line parameters
  1829.      to POV-Ray.  This means that the command line parameters are written
  1830.      into a COMMAND DEFINITION FILE that POV-Ray reads at run time.  POVMenu
  1831.      puts it's command line parameters into a file called 'POVMENU.DEF'.
  1832.      Then POV-Ray is called with the following command line:
  1833.      
  1834.              POVRAY POVMENU.DEF
  1835.      
  1836.      Note that this process will override any environmental settings in
  1837.      effect at run time.  See the POV-Ray docs for further information.
  1838.      
  1839.      The COMMAND LINEs are samples of the command lines that POVMenu will
  1840.      build and call POV-Ray with.  They are provided so that you may look
  1841.      at them and verify that the proper information is being passed.
  1842.      
  1843.      
  1844.      IF YOU HAVE PROBLEMS WITH POVMenu
  1845.      ----------------------------------------------------------------------
  1846.      !CAUTION!  POVMenu has very little error trapping built in.  It does
  1847.      not verify that the path names and programs specified on the
  1848.      configuration screen exist.  It trusts that you have entered correct
  1849.      information.  It will blindly call the program names and specify the
  1850.      paths that you enter.  If they are incorrect, there are no harmful
  1851.      effects, other than the menu picks will not function properly if
  1852.      incorrect information is specified on the configuration screen.
  1853.      
  1854.      If a menu pick does not appear to work correctly, check the values
  1855.      entered into the associated fields on the configuration screen.  It's
  1856.      a pretty good bet that you 'fat fingered' something.
  1857.      
  1858.      Many people have used POVMenu with great success.  I is (to my
  1859.      knowledge) error free (if set up correctly), and that works quite
  1860.      reliably.  If you have problems with it, please contact me and I will
  1861.      do what I can straighten it out.  If we discover that my code is
  1862.      broke, I'll fix it and send you a new copy, no extra charge!
  1863.      
  1864.      
  1865.      PROGRAM CREDITS
  1866.      ----------------------------------------------------------------------
  1867.      A lot of programs are mentioned in this document.  I felt that I
  1868.      should give credit to their copyright holders...
  1869.      
  1870.              POV-Ray is copyrighted by the POV-Ray development team.
  1871.      
  1872.  
  1873.  
  1874.      POVMenu v1.1 - The Menu Shell For POV-Ray v1.0                Page  31 
  1875.      ======================================================================
  1876.  
  1877.  
  1878.              QEdit is copyrighted by SemWare.
  1879.      
  1880.              Multi-Edit is copyrighted by American Cybernetics.
  1881.      
  1882.              IMAGE PROCESS is copyrighted by John Wagner.
  1883.      
  1884.              Image Alchemy is copyrighted by Handmade Software.
  1885.      
  1886.              TGA2GIF & CUTTGA are copyrighted by Sun Country Software.
  1887.      
  1888.              PicLab is public domain software by Lee Daniel Crocker &
  1889.              The Stone Soup Group.
  1890.      
  1891.              VPIC is copyrighted by Bob Montgomery.
  1892.      
  1893.              CShow is copyrighted by Bob Berry, Canyon State Systems &
  1894.              Software.
  1895.      
  1896.              LIST.COM is copyrighted by Vernon D. Burg.
  1897.      
  1898.              QDos is copyrighted by Gazelle Software.
  1899.      
  1900.              X-Tree is copyrighted by the X-Tree Company.
  1901.      
  1902.              C-Render is copyrighted by SoftTronics.
  1903.      
  1904.              C-Mapper is copyrighted by SoftTronics.
  1905.      
  1906.              Coil is copyrighted by W. D. Kirby.
  1907.      
  1908.              POVscape is copyrighted by John Stanley.
  1909.      
  1910.      I had nothing to do with the creation of any of these programs and
  1911.      claim no rights to them.  If you use any of these program that are
  1912.      shareware, please register them!
  1913.      
  1914.      Oh!  I almost forgot...
  1915.      
  1916.              GIF is a trademark of Compuserve.
  1917.      
  1918.              IBM is a trademark of International Business Machines.
  1919.      
  1920.      
  1921.      RELEASE HISTORY
  1922.      ----------------------------------------------------------------------
  1923.      
  1924.      08 AUG 92 - version 1.0, first release.
  1925.      
  1926.      24 DEC 92 - version 1.1b BETA release.
  1927.      
  1928.      [END POVMENU.DOC]
  1929.  
  1930.